1. 실행환경 세팅

환경별 구성 방법:

사전 요구사항

필수 소프트웨어

Docker Desktop이 설치되어 있어야 함

• Windows: Docker Desktop for Windows
• macOS: Docker Desktop for Mac
• 버전: 4.0.0 이상 (Kubernetes 지원)

참고: Docker 환경 설정이 되어 있지 않다면 먼저 도커/1. 실행환경 세팅.md 문서를 참고하여 Docker Desktop을 설치할 것

kubectl 설치 확인

PowerShell (Windows) / Terminal (macOS/Linux):

# kubectl 버전 확인
kubectl version --client

출력 예시:

Client Version: v1.29.2
Kustomize Version: v5.0.4-0.20230601165947-6ce0bf390ce3

kubectl이 설치되어 있지 않은 경우:

Docker Desktop을 설치했다면 kubectl은 자동으로 함께 설치됨. 위 명령어가 작동하지 않으면 Docker Desktop 재설치 또는 별도 kubectl 설치 필요

Docker Desktop Kubernetes 활성화

1단계: Docker Desktop 설정 열기

Windows:

1. 작업 표시줄에서 Docker Desktop 아이콘 우클릭
2. "Settings" 또는 "Dashboard" 클릭 후 설정(톱니바퀴) 아이콘

macOS:

1. 상단 메뉴 바에서 Docker 아이콘 클릭
2. "Preferences..." 또는 "Settings" 선택

2단계: Kubernetes 기능 활성화

설정 화면:

Docker Desktop Settings
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

왼쪽 메뉴:
├─ General
├─ Resources
├─ Docker Engine
├─ Kubernetes        ← 여기 선택
├─ Software Updates
└─ ...

Kubernetes 탭:
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

☑ Enable Kubernetes

Show system containers (advanced)
☐ ...

Kubernetes version: v1.29.2

[Apply & Restart]

활성화 단계:

1. 왼쪽 메뉴에서 "Kubernetes" 클릭
2. "Enable Kubernetes" 체크박스 선택
3. 하단의 "Apply & Restart" 버튼 클릭
4. Docker Desktop 재시작 대기 (1~2분 소요)

3단계: 활성화 진행 상황 확인

Docker Desktop 상태:

작업 표시줄/메뉴 바 아이콘 상태:
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

[진행 중]
   Docker Desktop is starting...
   Kubernetes is starting...

[완료]
   Docker Desktop is running
   Kubernetes is running

마우스를 아이콘 위에 올리면 상태 확인 가능

4단계: 활성화 완료 확인

PowerShell / Terminal:

# 현재 kubectl 컨텍스트 확인
kubectl config current-context

출력:

docker-desktop

의미:

• kubectl이 Docker Desktop의 Kubernetes 클러스터에 자동 연결됨
• 별도 설정 없이 즉시 사용 가능

Kubernetes 클러스터 확인

클러스터 정보 확인

# 클러스터 정보 출력
kubectl cluster-info

출력 예시:

Kubernetes control plane is running at https://kubernetes.docker.internal:6443
CoreDNS is running at https://kubernetes.docker.internal:6443/api/v1/namespaces/kube-system/services/kube-dns:dns/proxy

To further debug and diagnose cluster problems, use 'kubectl cluster-info dump'.

확인 사항:

• Kubernetes API 서버 주소: https://kubernetes.docker.internal:6443
• CoreDNS 정상 작동 확인

노드 확인

# 클러스터 노드 목록
kubectl get nodes

출력 예시:

NAME             STATUS   ROLES           AGE   VERSION
docker-desktop   Ready    control-plane   5m    v1.29.2

필드 설명:

특징:

• Docker Desktop Kubernetes는 단일 노드 클러스터
• 마스터(control-plane)와 워커 역할을 모두 수행
• 개발 및 학습용으로 충분

시스템 Pod 확인

# kube-system 네임스페이스의 Pod 확인
kubectl get pods -n kube-system

출력 예시:

NAME                                     READY   STATUS    RESTARTS   AGE
coredns-5dd5756b68-xxxxx                 1/1     Running   0          5m
coredns-5dd5756b68-yyyyy                 1/1     Running   0          5m
etcd-docker-desktop                      1/1     Running   0          5m
kube-apiserver-docker-desktop            1/1     Running   0          5m
kube-controller-manager-docker-desktop   1/1     Running   0          5m
kube-proxy-xxxxx                         1/1     Running   0          5m
kube-scheduler-docker-desktop            1/1     Running   0          5m
storage-provisioner                      1/1     Running   0          5m
vpnkit-controller                        1/1     Running   0          5m

주요 컴포넌트:

정상 상태: 모든 Pod의 STATUS가 Running이어야 함

Linux 환경 세팅

사전 요구사항

Docker Engine이 설치되어 있어야 함

참고: Docker 환경 설정이 되어 있지 않다면 먼저 도커/1. 실행환경 세팅.md 문서의 Linux 섹션을 참고하여 Docker Engine을 설치할 것

1단계: kubectl 설치

# 최신 kubectl 다운로드
curl -LO "https://dl.k8s.io/release/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/linux/amd64/kubectl"

# 실행 권한 부여
chmod +x kubectl

# 시스템 경로로 이동
sudo mv kubectl /usr/local/bin/

# 설치 확인
kubectl version --client

출력 예시:

Client Version: v1.29.2
Kustomize Version: v5.0.4-0.20230601165947-6ce0bf390ce3

2단계: Minikube 설치

# Minikube 바이너리 다운로드
curl -LO https://storage.googleapis.com/minikube/releases/latest/minikube-linux-amd64

# 실행 권한 부여
chmod +x minikube-linux-amd64

# 시스템 경로로 이동
sudo mv minikube-linux-amd64 /usr/local/bin/minikube

# 설치 확인
minikube version

출력 예시:

minikube version: v1.32.0
commit: 8220a6eb95f0a4d75f7f2d7b14cef975f050512d

3단계: Minikube 클러스터 시작

# Minikube 클러스터 시작 (Docker 드라이버 사용)
minikube start --driver=docker

# 또는 VM 기반 (KVM 사용)
# minikube start --driver=kvm2

출력 예시:

minikube v1.32.0 on Ubuntu 22.04
Using the docker driver based on user configuration
Starting control plane node minikube in cluster minikube
Pulling base image ...
Creating docker container (CPUs=2, Memory=2200MB) ...
Preparing Kubernetes v1.29.0 on Docker 24.0.7 ...
    - Generating certificates and keys ...
    - Booting up control plane ...
    - Configuring RBAC rules ...
Configuring bridge CNI (Container Networking Interface) ...
Verifying Kubernetes components...
    - Using image gcr.io/k8s-minikube/storage-provisioner:v5
Enabled addons: storage-provisioner, default-storageclass
Done! kubectl is now configured to use "minikube" cluster and "default" namespace by default

소요 시간: 첫 실행 시 약 1~2분

4단계: 클러스터 확인

# 현재 컨텍스트 확인
kubectl config current-context

출력:

minikube

# 노드 확인
kubectl get nodes

출력 예시:

NAME       STATUS   ROLES           AGE   VERSION
minikube   Ready    control-plane   2m    v1.29.0

# 시스템 Pod 확인
kubectl get pods -n kube-system

출력 예시:

NAME                               READY   STATUS    RESTARTS   AGE
coredns-5dd5756b68-xxxxx           1/1     Running   0          2m
etcd-minikube                      1/1     Running   0          2m
kube-apiserver-minikube            1/1     Running   0          2m
kube-controller-manager-minikube   1/1     Running   0          2m
kube-proxy-xxxxx                   1/1     Running   0          2m
kube-scheduler-minikube            1/1     Running   0          2m
storage-provisioner                1/1     Running   0          2m

5단계: Minikube 기본 명령어

# Minikube 상태 확인
minikube status

# Minikube 중지
minikube stop

# Minikube 재시작
minikube start

# Minikube 삭제
minikube delete

# Minikube 대시보드 실행 (웹 UI)
minikube dashboard

Docker Desktop vs Minikube 차이점

kubectl 기본 사용법

주요 명령어 구조

kubectl [명령어] [리소스타입] [리소스이름] [옵션]

명령어 카테고리:

리소스 타입 및 축약형

# 전체 이름 사용
kubectl get pods
kubectl get services
kubectl get deployments

# 축약형 사용 (동일한 결과)
kubectl get po
kubectl get svc
kubectl get deploy

주요 리소스 타입:

네임스페이스 사용

# 특정 네임스페이스의 리소스 조회
kubectl get pods -n kube-system

# 모든 네임스페이스의 리소스 조회
kubectl get pods --all-namespaces

# 축약형
kubectl get pods -A

기본 네임스페이스:

첫 번째 테스트

nginx Pod 실행

# nginx Pod 생성 (명령형)
kubectl run nginx-test --image=nginx:latest

출력:

pod/nginx-test created

Pod 상태 확인

# Pod 목록 조회
kubectl get pods

출력 예시:

NAME         READY   STATUS    RESTARTS   AGE
nginx-test   1/1     Running   0          10s

STATUS 단계:

Pod 상세 정보 확인

# Pod 상세 정보
kubectl describe pod nginx-test

출력 예시 (일부):

Name:             nginx-test
Namespace:        default
Priority:         0
Service Account:  default
Node:             docker-desktop/192.168.65.3
Start Time:       Thu, 09 Jan 2026 10:00:00 +0900
Labels:           run=nginx-test
Status:           Running
IP:               10.1.0.10
...
Events:
  Type    Reason     Age   From               Message
  ----    ------     ----  ----               -------
  Normal  Scheduled  20s   default-scheduler  Successfully assigned default/nginx-test to docker-desktop
  Normal  Pulling    19s   kubelet            Pulling image "nginx:latest"
  Normal  Pulled     15s   kubelet            Successfully pulled image "nginx:latest"
  Normal  Created    15s   kubelet            Created container nginx-test
  Normal  Started    15s   kubelet            Started container nginx-test

Pod 로그 확인

# Pod 로그 출력
kubectl logs nginx-test

출력 예시:

/docker-entrypoint.sh: /docker-entrypoint.d/ is not empty, will attempt to perform configuration
...
2026/01/09 01:00:00 [notice] 1#1: nginx/1.25.3

Pod 내부 접속

# Pod 내부 쉘 접속
kubectl exec -it nginx-test -- /bin/bash

컨테이너 내부에서 명령 실행:

# nginx 프로세스 확인
ps aux | grep nginx

# nginx 설정 파일 확인
cat /etc/nginx/nginx.conf

# 컨테이너 종료
exit

Pod 삭제

# Pod 삭제
kubectl delete pod nginx-test

출력:

pod "nginx-test" deleted

확인:

# Pod 목록 확인
kubectl get pods

출력:

No resources found in default namespace.

실습 디렉터리 생성

Windows (PowerShell)

# 실습 디렉터리 생성 (원하는 경로 사용)
# 예시: C 드라이브 또는 개인 문서 폴더
New-Item -ItemType Directory -Path C:\kubernetes_practice -Force
cd C:\kubernetes_practice

# 또는 개인 문서 폴더 사용
# New-Item -ItemType Directory -Path $env:USERPROFILE\Documents\kubernetes_practice -Force
# cd $env:USERPROFILE\Documents\kubernetes_practice

# 하위 디렉터리 생성
mkdir yaml
mkdir apps

# 디렉터리 구조 확인
tree /F

예상 출력:

C:\KUBERNETES_PRACTICE
├─apps
└─yaml

macOS / Linux (Bash)

# 실습 디렉터리 생성 (홈 디렉터리 권장)
mkdir -p ~/kubernetes_practice/{yaml,apps}
cd ~/kubernetes_practice

# 디렉터리 구조 확인
tree

예상 출력:

kubernetes_practice/
├── apps
└── yaml

참고: 자신의 환경에 맞는 디렉터리 경로 사용. Docker 실습 디렉터리와 같은 상위 폴더에 생성하는 것을 권장

컨텍스트 관리

컨텍스트 개념

컨텍스트(Context):

• kubectl이 연결할 클러스터, 사용자, 네임스페이스 정보의 조합
• 여러 클러스터를 손쉽게 전환 가능
• ~/.kube/config 파일에 저장됨

컨텍스트 확인

# 현재 컨텍스트 확인
kubectl config current-context

출력:

docker-desktop

컨텍스트 목록 조회

# 모든 컨텍스트 보기
kubectl config get-contexts

출력 예시:

CURRENT   NAME             CLUSTER          AUTHINFO         NAMESPACE
*         docker-desktop   docker-desktop   docker-desktop

필드 설명:

컨텍스트 전환 (여러 클러스터 사용 시)

# 다른 컨텍스트로 전환 (예: minikube)
kubectl config use-context minikube

# docker-desktop으로 다시 전환
kubectl config use-context docker-desktop

kubeconfig 파일 확인

# Windows PowerShell
cat $env:USERPROFILE\.kube\config

# macOS / Linux
cat ~/.kube/config

파일 구조 (YAML 형식):

apiVersion: v1
kind: Config
clusters:
  - cluster:
      server: https://kubernetes.docker.internal:6443
      certificate-authority-data: [인증서 데이터]
    name: docker-desktop
contexts:
  - context:
      cluster: docker-desktop
      user: docker-desktop
    name: docker-desktop
current-context: docker-desktop
users:
  - name: docker-desktop
    user:
      client-certificate-data: [인증서 데이터]
      client-key-data: [키 데이터]

실습 준비 완료 확인

체크리스트

다음 명령어가 모두 정상 작동하면 실습 준비 완료:

# 1. kubectl 버전 확인
kubectl version --client

# 2. 클러스터 연결 확인
kubectl cluster-info

# 3. 노드 확인
kubectl get nodes

# 4. 시스템 Pod 확인
kubectl get pods -n kube-system

# 5. 테스트 Pod 생성 및 삭제
kubectl run test --image=nginx
kubectl get pods
kubectl delete pod test

모든 명령어가 성공하면 실습 환경 설정 완료

참고 자료

공식 문서:

• Kubernetes 공식 문서: https://kubernetes.io/docs/
• kubectl 치트시트: https://kubernetes.io/docs/reference/kubectl/cheatsheet/
• Docker Desktop Kubernetes: https://docs.docker.com/desktop/kubernetes/

커뮤니티:

• Kubernetes Slack: https://slack.k8s.io/
• Stack Overflow: https://stackoverflow.com/questions/tagged/kubernetes

모든 명령어가 성공하면 실습 환경 설정 완료

kubectl 생산성 향상 설정

kubectl 단축어 설정 (alias)

kubectl을 k로 단축하여 사용 가능

Windows (PowerShell)

PowerShell 프로필 파일 편집:

# 프로필 파일 존재 여부 확인
Test-Path $PROFILE

# 프로필 파일이 없으면 생성
if (!(Test-Path $PROFILE)) {
    New-Item -ItemType File -Path $PROFILE -Force
}

# 메모장으로 프로필 파일 열기
notepad $PROFILE

프로필 파일에 다음 내용 추가:

# kubectl 단축어
Set-Alias -Name k -Value kubectl

저장 후 PowerShell 재시작 또는 프로필 다시 로드:

# 프로필 다시 로드
. $PROFILE

테스트:

# 이제 k만 입력해도 kubectl과 동일하게 작동
k get nodes
k get pods
k version --client

macOS / Linux (Bash)

~/.bashrc 파일 편집:

# bashrc 파일 열기
nano ~/.bashrc

# 또는 vim 사용
# vim ~/.bashrc

파일 맨 아래에 다음 내용 추가:

# kubectl 단축어
alias k='kubectl'

저장 후 변경사항 적용:

# bashrc 다시 로드
source ~/.bashrc

테스트:

k get nodes
k get pods

macOS / Linux (Zsh)

macOS는 기본 셸이 Zsh이므로 ~/.zshrc 사용:

# zshrc 파일 열기
nano ~/.zshrc

파일 맨 아래에 다음 내용 추가:

# kubectl 단축어
alias k='kubectl'

저장 후 변경사항 적용:

# zshrc 다시 로드
source ~/.zshrc

kubectl 자동완성 설정

명령어를 일부만 입력하고 Tab 키를 눌러 자동완성 가능

예: k des + Tab → k describe

Windows (PowerShell)

# PowerShell 프로필 파일 열기
notepad $PROFILE

다음 내용 추가:

# kubectl 자동완성
kubectl completion powershell | Out-String | Invoke-Expression

# k 단축어에도 자동완성 적용
Register-ArgumentCompleter -CommandName k -ScriptBlock $__kubectlCompleterBlock

저장 후 PowerShell 재시작 또는:

. $PROFILE

테스트:

# 'des' 입력 후 Tab 키 → 'describe'로 자동완성
k des<Tab>

# 'get po' 입력 후 Tab 키 → 'get pods'로 자동완성
k get po<Tab>

macOS / Linux (Bash)

# bashrc 파일 열기
nano ~/.bashrc

다음 내용 추가:

# kubectl 자동완성
source <(kubectl completion bash)

# k 단축어에도 자동완성 적용
complete -o default -F __start_kubectl k

저장 후:

source ~/.bashrc

테스트:

# 'des' 입력 후 Tab 키
k des<Tab>  # describe로 자동완성

# 리소스 이름도 자동완성
k get pods my-<Tab>  # 실제 Pod 이름으로 자동완성

macOS / Linux (Zsh)

# zshrc 파일 열기
nano ~/.zshrc

다음 내용 추가:

# kubectl 자동완성
source <(kubectl completion zsh)

# k 단축어에도 자동완성 적용
compdef k=kubectl

저장 후:

source ~/.zshrc

자동완성 사용 예시

설정 완료 후 다음과 같이 사용 가능:

# 명령어 자동완성
k get<Tab>           # get 다음에 사용 가능한 리소스 목록 표시
k des<Tab>           # describe로 자동완성
k del<Tab>           # delete로 자동완성

# 리소스 타입 자동완성
k get po<Tab>        # pods로 자동완성
k get de<Tab>        # deployments로 자동완성
k get sv<Tab>        # services로 자동완성

# 리소스 이름 자동완성
k describe pod nginx-<Tab>   # 실제 존재하는 Pod 이름으로 자동완성
k delete pod my-app-<Tab>    # 실제 존재하는 Pod 이름으로 자동완성

# 네임스페이스 자동완성
k get pods -n kube-<Tab>     # kube-system으로 자동완성

CKA/CKAD 시험 환경과 동일하게 설정

CKA/CKAD 시험에서 제공되는 기본 설정:

# ~/.bashrc 또는 ~/.zshrc에 추가
alias k='kubectl'
source <(kubectl completion bash)  # 또는 zsh
complete -o default -F __start_kubectl k

이 설정은 Kubernetes 공식 인증 시험에서 기본으로 제공되므로, 로컬 환경에서도 동일하게 구성하면 시험 준비에 도움됨.

설정 확인

단축어 확인:

# Windows PowerShell
Get-Alias k

# macOS / Linux
alias | grep kubectl

출력 예시:

CommandType     Name                      Version    Source
-----------     ----                      -------    ------
Alias           k -> kubectl

자동완성 테스트:

# 명령어 일부만 입력 후 Tab 키
k get po<Tab>
k des<Tab>
k dele<Tab>

정상적으로 자동완성되면 설정 완료.